home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pcb15nw.zip / README.1ST < prev    next >
Text File  |  1993-05-10  |  6KB  |  150 lines
  1. BETA TESTER INSTALLATION INSTRUCTIONS
  2. =====================================
  3.  
  4. Important Information:   1) Backup first
  5.                          2) You will need to upgrade your PCBTEXT files
  6.                          3) You will need to modify your event processing
  7.                          4) You will need a valid work directory
  8.                          5) Your system *may* need to maintain old index files
  9.  
  10. Details for the items 2 through 5, above, will be outlined below.  They have
  11. been mentioned here just to make sure you are aware of them before proceeding.
  12.  
  13.  
  14.  
  15. Installation instructions:
  16.  
  17.  1) Make sure you run BOARD.BAT at least once.  That way any SET commands
  18.     that are in your board.bat file will be executed and put into the
  19.     environment.  PCBSetup will use your previous SET PCB= settings to
  20.     help you configure v15.0 correctly.
  21.  
  22.     NOTE:  This step will be required on EACH NODE that you convert.
  23.  
  24.  2) Make sure all nodes are down at this point.
  25.  
  26.  3) Go to one of your \PCB directories (where you run PCBoard) and type
  27.     PCBSETUP.  If desired, you can simply load, exit and save.  You're done
  28.     converting pcboard.dat and creating a new file called cnames.add at this
  29.     point.
  30.  
  31.  4) Go to where your PCBTEXT files are stored.  Run FIXTEXT on each of your
  32.     PCBTEXT files.  You can automate it like this:
  33.  
  34.           for %1 in (pcbtext.*) do fixtext %1 > nul
  35.  
  36.     NOTE:  You may want to save a backup of your PCBTEXT file.  There are a
  37.     number of records in that file which will be replaced with new records.
  38.     As much effort as possible has been put into preserving your EXISTING
  39.     customizations, however, some records will simply have to be re-customized.
  40.  
  41.     You could take a sample PCBTEXT file and type FIXTEXT PCBTEXT > CHANGES and
  42.     then look at the contents of the CHANGES file to see what all has been
  43.     done to your PCBTEXT file.
  44.  
  45.  5) Go back to the \PCB directory and type:
  46.  
  47.           PCBPACK /AREA:ALL /INDEX
  48.  
  49.     The above step need be done only once for the system.  You do not need
  50.     to repeat this command for each node.
  51.  
  52.     In this step, PCBPACK is creating some new index files which v15.0 uses
  53.     to speed up access to the message base.
  54.  
  55.  6) EVENT CHANGES:
  56.  
  57.     Edit your BOARD.BAT file and REMOVE the line that says:
  58.  
  59.               if exist event.bat rename event.bat event.sys
  60.  
  61.     Do _NOT_ remove the line that EXECUTES your event.bat file.
  62.  
  63.     PCBoard no longer runs the event by renaming event.sys.  It now works more
  64.     like a door by copying your event file(s) to EVENT.BAT and then, when done,
  65.     PCBoard *itself* will remove the event.bat file - at the same time it will
  66.     record in the callers log that the event is done.
  67.  
  68.     RECOMMENDATION:
  69.  
  70.     Copy your EVENT.SYS file to your MAIN subdirectory changing its name to
  71.     something like MAINEVNT (without an extension).
  72.  
  73.     Now run PCBSetup.  Go to the EVENT screen and press F2 on the EVENT.DAT
  74.     file.  Enter the information as follows, setting the time appropriately
  75.     for your system:
  76.  
  77.                  Batch     Begin  End              Last      Days
  78.        Act  Mod  File      Time   Time   Date      Date      SMTWTFS  Node
  79.        ═══  ═══  ════════  ═════  ═════  ════════  ════════  ═══════  ═════
  80.     1)  Y    E   MAINEVNT  02:00  02:15                      YYYYYYY  0
  81.  
  82.     In the example above, PCBoard will copy MAINEVNT to the EVENT.BAT file at
  83.     02:00 and then exit and run EVENT.BAT.  See the WHATSNEW file for further
  84.     details on the changes and capabilities of the event system.
  85.  
  86.     =========================================
  87.     PLEASE READ EVENT.DOC FOR FURTHER DETAILS
  88.     =========================================
  89.  
  90.  7) Delete your USERNET.XXX file.  PCBoard will recreate it.
  91.  
  92.  8) Edit your board.bat file and where it says PCB145, change it to PCBOARD.
  93.  
  94.  9) If you are using any kind of NETMAIL or offline mail reader - programs
  95.     which access the message base - then you should edit your BOARD.BAT file
  96.     and change the "SET PCB=" line.  Add to it the word /OLDINDEX.
  97.  
  98.     This change tells PCBoard to maintain both the old and the new index
  99.     files.  If you are not using any kind of offline mail reader, if you have
  100.     chosen to use only PCBoard v15.0's built-in QWK capability, if you are
  101.     not using any netmail software, then you do NOT need to use /OLDINDEX and
  102.     can save disk space by not using it.
  103.  
  104.     In addition, you will need to modify your PCBPACK processing adding the
  105.     word /OLDINDEX on the command line.  For example:
  106.  
  107.               PCBPACK /AREA:ALL /DAY:30 /OLDINDEX
  108.  
  109.     This will allow PCBPACK to perform the pack, as usual, and update the
  110.     OLD index files at the same time.
  111.  
  112. At this point you may now bring the system back up.
  113.  
  114. Feel free to play with PCBSetup.  It will help you explore some of the new
  115. features in PCBoard until we can get some documentation going.  Also, of
  116. tremendous help (until more documentation comes along) will be the WHATSNEW
  117. file.  Please take the time to read it.  It will save everyone time and it
  118. will let you get the most out of the v15.0 software.
  119.  
  120. It is important that everyone understand that the "feature set" of v15.0 is
  121. frozen.  There will be no NEW features added to v15.0 during the beta cycle.
  122.  
  123. However, due to the *many* additions that have already been made, there may
  124. be certain areas of the code which require enhancements to "smooth out the
  125. rough edges".
  126.  
  127. Please hold your wishlist items for the next release of PCBoard.  Or...
  128. understand when we simply capture them and do not put them into version 15.0
  129. that this is being done on purpose in order to get the software out the door
  130. and available to everyone as quickly as possible.
  131.  
  132.  
  133. WARNING
  134. =======
  135. You must set a valid Work Directory, something other than the 'current
  136. directory' since the QWK command expects the work directory to contain the
  137. *.DAT and *.NDX files that go into creating a QWK packet.  Also, the name of
  138. the file must be set in PCBSetup : Configuration Options : Messages "Name of
  139. capture file".
  140.  
  141.  
  142. WARNING
  143. =======
  144. All versions of PCBoard are now OVERLAID and that means that the executable
  145. contains overlays inside of it.  In order to avoid getting sharing violations
  146. when attempting to share one pcboard.exe file amongst multiple nodes, you must
  147. set the pcboard.exe to read only.  Example:
  148.  
  149.          ATTRIB +R PCBOARD.EXE
  150.